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Chapter 1 


LOADING AND RUNNING DEBUG 


LOADING DEBUG 


The Cromemco Debug program makes it possible to test, 
debug, and trace through user programs. Debug is loaded 
into memory at l100H and moved to the highest memory 
available. 


Loading Debug is accomplished by typing one of the 
following commands: 


DEBUG 
DEBUG file-ref 


where file-ref is a file reference to the program to be 
tested. When run under CDOS the jump instruction 
located at location 5H is changed to jump to the start 
of Debug. This allows locations 6H and 7H to still 
point to the lowest available memory location (below 
Debug). 


When run under the Cromix Operating System, the CDOS 
simulator allows Debug to operate properly. 


The second form of the command is used to load Debug and 
the file to be tested into memory. If the file name 
extension is HEX, then the file is read as an Intel 
format HEX file. A file with any other file name 
extension is read as an absolute binary file and loaded 
at location l100H. Note that Debug does not link 

j ° If a relocatable file (with a file 
name extension of REL) is specified it will be loaded as 
if it were a binary file and will not be executable. 


CONTROL CHARACTERS 


Control characters are used in Debug to help enter 
commands. These control characters are the same ones 
CDOS uses. 
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Control-C (°C) return to CDOS 

Control-H (7H) delete character and backspace on CRT 
Control-U (“*U) delete line 

Control-V (“V) delete line 

Control-X (*X) delete character and echo 

underscore (_) delete character and backspace on CRT 
RUBout (DEL) delete character and backspace on CRT 


While displaying new information (such as that which is 
displayed by the DM command) the following characters 
may be used: 


Control-S (7S) stop/start printing or listing to 
the console. If printing, this 
character will stop the printing. 
If already stopped by the use of a 
CTRL-S, this or any other character 
will resume the printing. 


space (or any other character) will abort 
the printing or console display, 
prompt, and wait for the next 
command. 


COMMAND FORMAT 


Debug is controlled by one and two character commands 
from the terminal. The format is free-form with respect 
to spaces. Commas may be used in place of spaces. 
Remember that all commands must be terminated with a 
carriage RETURN. The following examples all display 
memory Starting at location 1000H and ending at location 
1OFFH. 


D1000 10FF 
DM1000S100 
DM 1000,10FF 
D 1000,S100 
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CURRENT PROGRAM COUNTER LOCATION (S$) 


The current address (the current value of the program 
counter) may be represented by a dollar sign ($). The 
following command will begin program execution at the 
current value of the program counter and will stop 
execution (by the use of a temporary break point) when 
the program counter reaches its current value plus 3: 


G/$3 


COMMAND STARTING ADDRESS 


The Assemble into Memory (A), Display Memory (DM or D), 
List in Assembler Mnemonics (L), and Substitute Memory 
(SM or S) commands each maintain a starting address to 
use if none is given with the command. This address is 
changed each time one of the specified commands is 
executed so that the next execution of the command will 
commence where the last one ended. When Debug is 
entered each of the starting addresses is set to 100H. 


@ REGISTER 


Debug is designed to aid the programmer in testing 
relocatable programs. The @ register is used to tell 
Debug where the module you wish to debug is located. 
This address can be found from the map generated by the 
Cromemco linking loader LINK. To change the @ register, 


type: 


on the console. Debug will then display: 
@—-xXxXX 


where xxxx is the current value of the @ register. The 
computer will then wait for a new address. If only a 
RETURN is typed, the register will remain unchanged. If 
an address and a carriage RETURN is typed, then the 
register will contain the new address. The @ register 
may now be used as part of an address: 
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G/@ @A3 1000 


This is an example of the GO command. Break points will 
be set at the beginning of the current module, relative 
location A3H in the current module, and at location 
1000H. This feature allows you to test a module without 
having to calculate absolute addresses. 


The relative address is displayed in addition to the 
absolute address whenever addresses are displayed unless 
the @ register equals zero. 


ADDRESS EXPRESSIONS 


For additional ease in specifying addresses an 
expression can be used. Within these expressions, 
addition, subtraction, the relative address (@) 
register, and the current program counter location (S$) 
may be used. If many modules are being tested, addition 
can be used to specify relative addresses. 
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EXPRESSIONS 
Special Symbols: 
“reg Register value (see Summary of Register 
Names) 
@ @ register 
$ Program counter 
(expr) Contents of memory addressed by "expr" 
[expr] Used to alter order of evaluation 
'xy' ASCII value of "xy" 
ddddd. Decimal number 
hhhh Hexadecimal number 
Unary Operators: 
+ Positive number 


- Negative number 
~ Logical Not (complement) 


Binary Operators: 


+ Addition 

- Subtraction 

* Multiplication 
% Division 

& Logical And 


Logical Or 
Relational Operators: 


Equal to 

Not equal to 

Greater than 

Greater than or equal to 
Less than 

Less than or equal to 


RAVVAT 
| Vv 


An expression can be used in Debug anywhere that a 
number is needed, i.e., for addresses, data, etc. 
Expressions must not contain any imbedded spaces. The 
precedence of operators is as follows: 


1. Special symbols (highest precedence) 
2. Unary operators 

3. Binary operators 

4. Relational operators (lowest precedence) 


The order of evaluation may be altered by the use of 
brackets ([ ]). 
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Among operators of the same precedence, evaluation 
proceeds from left to right. For example: 


10.4+20.*3. equals 90. (decimal) 
“DE=*HL equals 0000 if the DE register does 
not 


equal the HL register 
equals FFFF otherwise 


G/2321+A3 would set a break point at relative 
location A3H if the module is 
located at 2321H 


SWATH OPERATOR 


There are two ways to specify the address range of many 
commands. The first is to simply list the beginning and 
end addresses (and where appropriate, the destination 
address). For example, the first command below programs 
the range 0 through 13FFH into PROMs starting at 
location E400H. The second command displays the 
contents of memory between addresses E400H and E402H. 


PO 13FF E400 
DME400 E402 


Another way to do the same thing is to use the Swath 
operator to specify the width of the address range, 
rather than explicitly stating the end address. 


PQ S1400 E400 
DM £40053 


ERRORS 


Any errors made during command entry may be corrected by 
typing Control-V (“*V) to abort the line or by 
backspacing and correcting the line. If a carriage 
RETURN has already been entered and Debug detects an 
error, the line will not be accepted and a question mark 
will be displayed. The command must then be re-entered 
correctly. 
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Chapter 2 


DEBUG COMMANDS 


A -— ASSEMBLE INTO MEMORY 


This command allows the user to enter assembly language 
mnemonics from the console and have them assembled into 
memory. The command takes the following format: 


A 
A beginning-addr 


The first format assembles into memory starting at the 
default current address (initially 100H). The second 
format assembles starting at beginning-addr. 


The user is prompted with the absolute address, relative 
address, and the current instruction located at that 
address. 


Debug reads from the console and assembles the 
instruction into memory. The mnemonics for the various 
z-80 instructions can be found in the 2-80 CPU Technical 
Manual published by Mostek and Zilog (Cromemco part 
number 023-0045). If there is no error in the 
instruction it is assembled into memory and the user is 
prompted for the next instruction. The rules for 
address expressions apply to the addresses in the 
assembler mnemonics. In the following example the 4 
register contains 1234H. 


A@40 

1274 0040' NOP ADD B 

1275 0041' NOP CALL @93 
1278 0044' NOP JP 1032+95 
127B 0047' NOP ° 


If only a RETURN is typed by the user, Debug does not 
alter the current instruction and goes to the next 
instruction in memory. 


The A command terminates when a line starting with a 
period (.) is entered. If there is an error in the 
input line, it will not be accepted, a question mark 
will be displayed, and the user will be prompted again. 
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B -— SET or DISPLAY PERMANENT BREAK POINTS 


The B command is used to set permanent break points. 
Using this feature, it is not necessary to repeatedly 
set break points when using the G command. A permanent 
break point will remain in effect until it is explicitly 
removed by the BX command. 


It is possible to set a total of 12 break points 
including the permanent breakpoints (B command), 
temporary breakpoints (G command), and tracing 
breakpoints (T and C commands). 


To display all of the currently active permanent break 
points enter the command: 


To set a permanent break point enter the command: 


B breakpoint-l breakpoint-2...breakpoint-—-n 


A break point is specified by up to four fields: 


Field Use 


R Report registers flag (optional) 

addr Memory address for break point 

{cond} Condition for break point (optional) 
:count Repeat count for break point (optional) 


The report registers flag is used to display the 
registers each time the break point is encountered 
during execution. This is used in conjunction with the 
repeat count field. 


The condition field is used to specify a conditional 
break point. If a condition is specified the break 
point will not stop the program unless the condition is 
true (non-zero). The condition can be any expression 
involving registers or memory. Fach time the user 
program reaches the break point address the expression 
is evaluated. If the result is false (zero) the user 
program continues as if the break point did not exist. 


The repeat count is used to stop the user program the 
nth time it reaches the break point address. The repeat 
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count is decremented each time the program reaches the 
break point. If the count goes to zero, the user 
program will be stopped. 


Note that if a condition and a repeat count are both 
used, the repeat count is only decremented if the 
condition is true. 


The repeat count is never reset to its original value. 
The programmer must respecify the break point (using the 
B command) if the repeat count needs to be reset. 


128 bytes are dedicated to conditional expressions so 
that all conditions together can contain a maximum of 
128 characters. 


B 106 


This will establish a permanent break point at memory 
location 106H. Whenever the program counter (PC) is 
equal to 106H program execution will stop and the 
registers will be displayed in standard format. 


B 106:5 


This variation on the first example will cause program 
execution to stop on the fifth execution of the 
instruction at 106H. The registers will be displayed 
only when program execution stops. 


B R106:5 


This time the report registers flag has been set so that 
each time the break point is passed the registers will 
be displayed. Again execution will be terminated the 
fifth time the instruction at location 106 is to be 
executed. 


B 106 {*A=0} 


Now a conditional permanent break point has been set. 
Execution will terminate and the registers will be 
displayed only when the program counter equals 106H and 
the A register equals 0. 
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B 5{[*C=9] [“C=A] } 225 


The final example in this section will stop program 
execution when, for the 25th time, the C register equals 
9H or AH and the program counter equals five. Register 
names are preceded by a caret (*) while hexadecimal 
numbers are not; the two should never be confused. When 
debugging a program which is running under CDOS, this 
break point will have the effect of stopping program 
execution on the 25th system call to print or input a 
buffered line. 
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BX -— DELETE PERMANENT BREAK POINTS 


This command is used to delete permanent break points. 
It has two formats: 


BX 
BX addr-l addr-2 ... 


The first format will delete all permanent break points. 
The second format will delete the break points at each 
of the specified addresses, 


ll 
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C — TRACE OVER CALLS 


Cc 
C number of instructions 
C {expr} 


The Trace Over Calls command functions in a manner 
Similar to the simple Trace command. The difference 
appears when a CALL or RET instruction is encountered in 
a multiple instruction trace. 


When a CALL instruction is encountered during the 
execution of the C command no tracing is performed in 
the called subroutine. Tracing resumes when control is 
returned to the current subroutine at the location which 
is three bytes beyond the CALL instruction. The 
number-of-instructions counter is not decremented while 
program control remains in the called subroutine. 


When a RET instruction is encountered during a multiple 
instruction trace, tracing will stop and the RET 
instruction will be displayed. This allows the 
programmer to stop execution of a subroutine before 
control is. returned to the calling routine. At this 
point the registers can be examined (and modified) 
before the return instruction is executed. 


Tf a conditional RET instruction (e.g., RET 2Z) is 
encountered program execution will stop only if the RET 
condition is true (i.e., if the RET instruction is to be 
executed). Otherwise the conditional RET instruction 
will be treated as any other instruction and program 
execution will continue. 


When the third form of the command is used execution 
will continue until the expression (expr) is true (not 
equal to 0). The expression will only be evaluated 
while program control remains within the current 
subroutine. The CALL and RET instructions function as 
described above. 
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CN — TRACE OVER CALLS WITH NO DISPLAY 


CN 
CN number of instructions 
CN {expr} 


The CN command is similar to the C command except that 
no information is displayed as the trace progresses. 
When the trace terminates, the standard register 
information is displayed. 
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CJ -— TRACE OVER CALLS WITH JUMPS 


CJ 
CJ number of instructions 
CJ {expr} 


The Trace Over Calls with Jumps command is similar to 
Trace Over Calls with one addition. Break points are 
established before all instructions which alter the 
program counter (i.e., JP and JR). 


The CALL and RET instructions function as they do in the 
Trace Over Calls command. 


With this command only JP, JR, and CALL instructions are 
traced and only the execution of these instructions 
cause the number of instructions counter to be 
decremented or the expression (expr) to be evaluated. 


Notice that a conditional RET instruction whose 
condition is not true (which means the RET instruction 
is not executed) will not stop program execution but 
will be traced and will cause the number of instructions 
counter to be decremented or the expression to ke 
evaluated. 


This command will supply the programmer with a history 


of the past n instructions which altered or could have 
altered the program counter. 
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CNJ -— TRACE OVER CALLS WITH JUMPS AND NO DISPLAY 


CNJ 
CNJ number of instructions 
CNJ {expr} 


The CNJ command is similar to the CJ command except that 
no information is displayed as the trace progresses. 
When the trace terminates, the standard register 
information is displayed. 
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D or DM —- DISPLAY MEMORY 


The contents of memory is displayed in hexadecimal 
notation. Each line of the display is preceded by the 
address of the first byte and is followed by the ASCII 
representation of the hexadecimal bytes. For example: 


DM100,S30 

0100 , 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F @ABCDEFGHIJRLMNO 
0110 50 51 52 53 54 55 56 57 58 59 5A 30 31 32 33 34 PORSTUVWXYZ01234 
0120 35 36 37 38 39 00 00 00 00 00 00 00 00 00 00 00 56789. .eccceecce 


If the @ register is not equal to zero the relative 
address will be displayed as follows (assume the @ 
register has been set to 100H): 


DM100,S30 

0100 o000' 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F @ABCDEFGHIJKLMNO 
0110 0010' 50 51 52 53 54 55 56 57 58 59 5A 30 31 32 33 34 PORSTUVWXYZ01234 
0120 0020" 35 36 37 38 39 00 00 00 O00 00 00 00 00 00 00 00 56789. .cceccocce 


The formats of this command are as follows: 


DM 

DM beginning-addr 

DM beginning-addr ending-addr 
DM beginning-addr S swath-width 
DM ,ending-addr 

DM S swath-width 


The M is optional in all formats. 


The first format displays memory from the current 
display address, initially 100H, and continues for 8 
lines. The second format displays from the beginning 
address and continues for 8 lines. The third format 
displays from the beginning address to the ending 
address. The fourth format displays from the beginning 
address for a length specified by the swath-width. The 
fifth format displays from the current display address 
to the ending address. The sixth format displays from 
the current display address for a length specified by 
the swath-width. 
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DR ~ DISPLAY REGISTERS 


When Debug is reentered from a break point, the user 
registers are saved. The registers may be displayed in 
response to the Debug prompt by typing the following 
command: 


-DR 
SZHVNCE A =00 BC =0000 DE =0000 HL =0000 SP=0100 PC=0100 0000' LD E,A 
SZHVNC A't=00 BC'=0000 DE'=0000 HL'=0000 Ix=0000 IY=0000 I=00 


Notice that the relative address of the program counter 
(PC) is displayed only if the @ register is not equal to 
Zero. 


The letters SZHVNC on the first row represent the flags, 
while on the second row they represent the prime flags. 
If the flag is on, it is displayed, if the flag is off, 
a space is displayed. If only the carry and zero flag 
are set then " Z C"™ would be displayed. The flags are 
described below. 


S - Sign flag, S=l if the MSB of the result is one, 
i.e., if the result is negative. 

Z—- Zero flag, Z=1 if the result of an operation is 
zero. 

H - Half-carry flag, H=l1 if the add operation produced 


a carry into the 4th bit of the accumulator or a 
subtract operation produced a borrow from the 4th 
bit of the accumulator. . 


V - Parity or overflow flag. This flag is affected by 
arithmetic and logical operations. If an overflow 
occurs during an arithmetic operation, the flag is 
set to one. After a logical operation, the flag is 
set to 1 if the result of the operation has even 


parity. 

N - Add/subtract flag, N=l1 if the last operation was a 
subtraction. 

C - Carry flag, C=l if the operation produced a carry. 


The E flag on the first line is the state of the 
interrupt flip-flop (IFF). If interrupts are enabled, 
the E is displayed, otherwise a space is displayed. 
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The A register is displayed next, followed by the BC, 
DE, and HL register pairs and the stack pointer. The 
program counter value is then displayed as both an 
absolute and relative address. The opcode pointed to by 
the program counter is then displayed as an instruction. 


On the second line, the prime registers are displayed, 
F' (prime flags), A', BC', DE', and HL'. The IX, IY, 
and I (interrupt page) registers are displayed next. If 
the disassembled opcode includes an address, the 
relative value of this address is displayed as the last 
item on the line. 


-DR 
S H NCE A =00 BC =0000 DE =0000 HL =0000 SP=0000 PC=1234 0010' CALL 1334 
SZ NC A'=00 BC'=0000 DE'=0000 HL'=0000 Ix=0000 ITY=0000 I=00 (0110') 
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E — EXAMINE INPUT PORT 
The data port is read and displayed as a hexadecimal 
number. The format of the command is: 


E data-port 


In the following example the data port 3 is read and 
displayed on the console. 


-E3 
23 
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EJ —- EJECT DISK 


The format of the command follows: 


EJ a 


The d is 
possible, 
ejected. 


the disk identifier (A, B, C, etc.). 


the diskette 


in the disk drive will 
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F -— SPECIFY FILE NAME 


This command allows the programmer to insert file names 
in the two default FCBs (at 5CH and 6CH) and the command 
line into the default buffer (at 80H). The example 
below loads FILE1.COM into the first FCB and FILE2.COM 
into the second FCB. The complete line is also loaded 
into the default buffer. 


-~FFILEL.COM FILE2.COM OPTION1 OPTION2 


This command can be used with the R command to read disk 
files. This command is compatible with the operation of 
the CDOS console processor code. 
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G - GO 


The GO command has the following format: 


G starting-addr/breakpoint-l1 breakpoint-2...breakpoint-n 


Each of the addresses is optional. If the starting 
address is omitted, then the contents of the program 
counter is used. The registers are loaded from the user 
registers (these are the values displayed by the DR 
command). Execution begins with the starting address or 
the contents of PC (the program counter). If break 
points were specified, an RST 30H is inserted at the 
break point addresses and a jump instruction is placed 
at location 30H. When a breakpoint is executed, control 
is returned to Debug, and all of the user registers are 
saved and displayed. All temporary breakpoints (those 
established by the G command) are then removed from the 
user program. Note the following about breakpoints: 


1. A temporary break point (as used in the G command) 
may be specified in the same manner and with the 
same fields (report registers flag, condition, and 
repeat count) aS a permanent break point (see the B 
command). 


2. Breakpoints can only be set in programs residing in 
RAM, This is because an RST 30H is inserted at 
each break point location. (The original contents 
of these locations are saved so that they can be 
restored after a break point is executed). 


3. Up to 12 break points can be set. If an attempt is 
made to enter more than 12 break points, the 
command will not be accepted. The 12 breakpoints 
may be composed of any combination of permanent and 
temporary breakpoints. 


4, When a break point is used, a jump instruction is 
stored at location 30H. Therefore locations 30H, 
31H, and 32H are not available to a user program. 


The reader is referred to the B and BX commands for 


description of permanent and conditional permanent break 
points. 
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H -— HEXADECIMAL ARITHMETIC 


H expr 
H exprl expr2 


The first format of the command evaluates the expression 
and displays the result in hexadecimal and decimal. 


The second format will perform hexadecimal addition and 
subtraction. The first number to be displayed is the 
sum of the two expressions. The second number is the 
difference between the first and second expression. 


In the following example two hexadecimal numbers (1234H 
and 321H) are added and subtracted. The first pair of 
numbers is the result of the addition displayed first in 
hexadecimal and then in decimal. The second pair of 
numbers is the result of the subtraction displayed ina 
Similar manner. 


-H 1234,321 
1555 5461., OF13 3859. 
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L — LIST IN ASSEMBLER MNEMONICS 


The list command is used to list the contents of memory 
in assembly language mnemonics. The formats of this 
command are: 


L 
L starting~-addr 

L starting-addr ending-addr 

L starting-addf S swath-width 
L ,ending-addr 

L S swath-width 


The first format lists 16 lines of disassembled code 
starting from the current list address (initially 100H). 
The second format lists 16 lines from the starting 
address. The third format lists from the starting 
address to the ending address. The fourth format lists 
from the starting address for a length specified by the 
swath width. The fifth format lists from the current 
list address to the ending address. The sixth format 
lists from the current address for a length specified by 
the swath-width. 


The first address of the disassemble is the absolute 
address. The second address is the relative address. 
If the disassembled instruction contains an address, the 
absolute address is displayed in the instruction in 
hexadecimal and the relative address is displayed to the 
right of the disassembled line. In the example that 
follows, the @ register contains 2800H. 


-L@800 @811 

3000 0800' ADD A,B 

3001 0801' CALL 3200 (0A00') 
3004 0804' CALL 3243 (0A43') 
3007 0807' CALL 3333 (0B33 ') 


300A O80A' LD A,B 

300B 080B' OR A,C 

300C O080C' JR Z,3000 (0800') 
300E O80E' INC HL 

300F O80F' INC DE 

3010 0810' INC BC 

3011 0811' LD A,H 
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M — MOVE MEMORY 


The formats of this command are: 


M source-addr source-end destination-addr 
M source-addr S swath-width destination-addr 


The first format moves the contents of memory beginning 
with the source address and ending with the source-end 
to the destination address. The second format uses the 
swath width to determine the length of the move. 


The move is verified to insure that all bytes were moved 
correctly. If an overlapping move was made, errors will 
be reported. The error reporting can be terminated by 
typing any character. 


The move command can be used to fill a block of memory 
with a constant. In the following example, a zero has 
been entered into location 100H using the SM command. 
The following command will move zeros from location 100H 
through 108H. 


-M100 S7 101 


Care should be taken not to move memory over Debug or 
CDOS. 
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O — OUTPUT TO DATA PORT 
This command outputs data to a data port. The following 


is the command format: 


O data-byte port-number 
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P — PROGRAM PROMS 


This command enables the user to program PROMs 
(Programable Read Only Memory chips). The following are 
the command formats: 


P source-addr source-end destination-addr 
P source-addr S swath-width destination-addr 


The first format programs PROMs starting with the source 
address and ending with the source-end into PROMs 
beginning at the destination address. The second format 
determines the length from the swath width. 


If the length of the source is not a multiple of 400H or 
if the destination does not begin at a 400H boundary, 
Debug will reject the command. (Multiples of 400H end 
in OOOH, 400H, 800H, and COOH). 


Any number of 2716, 2708 or 2704 PROMs can be programmed 
in the execution of one command as long as there are 
enough Cromemco PROM programming boards to contain them. 
Bach PROM is verified with its source after all are 
programmed and any discrepancies are displayed. If no 
discrepancies are found, a prompt is displayed and the 
next command may be entered. 


Software can be loaded into a PROM in as small 
increments as you desire, provided it is added to 
previously unused areas of the PROM. This is done by 
first using the Move command (M) to transfer the 
contents of the PROM to RAM, adding the new software to 
an area of RAM which corresponds to the unused portion 
of the PROM and finally using the Program command (P) to 
reprogram the PROM with the result. Although the entire 
PROM must always be programmed, it never hurts to 
rewrite the same data over again. In general, al may 
be written over al, a0O over either al or a 0, but the 
only way to change 0's to 1's is to erase the PROM with 
the appropriate UV light. (See the Cromemco Bytesaver 
II manual for details.) 
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Q —- QUERY MEMORY 


The format of the Query command is: 


Q beginning-addr ending-addr string-of-bytes 
Q beginning-addr S swath-width string-of-bytes 


This command is used to search through a specified area 
of memory for a certain string-of-bytes. The 
string-of-bytes is in the same format as the S or SM 
command. If the string-of-bytes is found, 16 bytes 
starting at the first byte which matches are displayed 
as in the DM command. 
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R — READ DISK FILE 


The R command is used with the F command to allow the 
programmer to read a disk file. The F command is used 
to specify the file name, and the R command causes the 
file to be read into memory. If the file has a file 
name extension of HEX, then the file is read as an Intel 
format HEX file. Any other file is considered to be a 
binary file and will be read directly into memory 
beginning at location 100H. The format of the R command 
is: 


R 
R displacement 


The first format reads the file with no displacement. 
The second format reads the file with a displacement. 
If the input file is in HEX, then the displacement is 
added to the address in the file to determine the 
address at which to store the file. If the file is a 
binary file, it will be stored at the displacement + 
100H. 


When the R command is executed Debug displays either a 
question mark if there is an error (file not found, 
checksum error, or attempting to read a file above 
highest available memory location) or the following 
message if there is no error: 


NEXT = xxxx 
NEXTM = yyyy 


Where xxxx-l is the highest memory address loaded by all 
R commands during this Debug session and yyyy-l is the 
highest memory address loaded during this R command. 
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S or SM - SUBSTITUTE MEMORY 


This command is used to substitute memory. The formats 
of this command are: 


SM 
SM starting-addr 


Note that the M is optional if the first character of 
the address does not match a register name. 


If the first format is used then the last substituted 
location (initially 100H) will be the starting address. 


Debug displays the absolute address, followed by the 
relative address, followed by the contents of the memory 
byte. One of the following may then be entered. 


1. A data-byte value followed by a carriage RETURN. 
The data byte value is stored at the address of the 
prompt. The address is then incremented by 1 and 
displayed on the next line. 


2. A string enclosed between apostrophes (') followed 
by a carriage RETURN. The string is stored 
beginning at the address of the prompt. The 
address is then incremented past the string and 
displayed on the next line. 


3. Any number of 1 and 2 above can be entered on one 
line with one carriage RETURN terminating the line. 
The address is then incremented past the bytes that 
were stored and the new address is displayed on the 
next line. 


4. A minus sign (-). A minus sign does not store a 
byte. The address will be decremented to the 
previous address. The minus Sign can be used to 
back up to a previous location in case an error was 
made. 


5. A carriage RETURN only. If no entry is made on the 
line, the memory byte remains unchanged. The 
address is incremented by 1 and displayed on the 
next line. 


6. A period(.). A period ends the input mode and 
returns control to the command level. 


In the example that follows, assume that the @ register 
contains the value 2800H: 
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-SM@100 


2900 
2901 
2902 
2919 
2928 
2929 
292A 
2929 
292A 


0100! 
0101' 
0102' 
0119' 
0128! 
0129! 
O12A' 
0129' 
O012A' 


32 
17 
31 
7A 
22 
29 
87 
55 
87 


0 
00 


'this is an ASCII string' 


'AAAA' 


00123 45 6 
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Sr ~ SUBSTITUTE REGISTER 


The Sr command allows the user registers to be altered. 
The letter r stands for the register which is to be 
changed. The section SUMMARY OF REGISTER NAMES gives a 
summary of the names that can be substituted. When 
substituting the F and F' flags, enter the command SF or 
SF'., Debug will then display the flags that are set and 
wait for the programmer to enter the names of the flags 
which are to be set. If the flags are NOT entered, the 
flags are reset. Before the following example the SZHC 
flags are set. After the example the ZC flags are set. 
The lower case letters are entered by the programmer. 


-sf 
SZH C ae 


When substituting a one byte register, a one byte value 
is accepted. When substituting a two byte register, a 
two byte value is accepted. For example, SD will allow 
the value of the D register to be changed, SE will allow 
the value of the E register to be changed, and SDE will 
allow the value of the D and E registers to be changed. 


Tf no value is entered, or if an error occurs, the value 


of the register remains unchanged. In the following 
example, the A register is changed to contain 41H. 


-Sa 
A=98 41 
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T — TRACE 


The format of the Trace command is: 


T 
T number of instructions 
T {expr} 


The first format traces the program through one 
instruction. The second format traces the program 
through number of instructions. The third format traces 
until the expression (expr) is true (not equal to 0). 
After every instruction is traced the values of the 
registers are displayed. 


A program can only be traced through RAM. The trace 
command places a break point after the instruction, 
loads the registers and executes the instruction. The 
break point is then executed and the registers are 
resaved. The registers are displayed and the next 
instruction is executed unless the number of 
instructions counter has reached zero or expr is true, 
in which case a prompt for the next command is 
displayed. 


To abort the trace, depress any key on the console. A 
prompt for the next command will then be displayed. 


If a permanent break point is reached during tracing, 
the trace will be stopped. 


T {*B>10} 


This command will trace the execution of a program, 
displaying the registers after each instruction, until 
the B register assumes a value greater than 10H. 


33 


Cromemco Debug Instruction Manual 
2. Debug Commands 


TN — TRACE WITH NO DISPLAY 


TN 
TN number of instructions 
TN {expr} 


The TN command is similar to the T command except that 
no information is displayed as the trace progresses. 
When the trace terminates, the standard register 
information is displayed. 
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TJ -— TRACE JUMPS 


TI 
TJ number of instructions 
TJ {expr} 


The TJ command is Similar to the T command except that 
break points are only placed in the user program before 
instructions which alter the program counter (i.e., JP, 
JR, CALL, and RET instructions). The registers will be 
displayed and the number of instructions counter 
decremented or the expression evaluated only when a 
program counter altering instruction is executed. For 
example: 


TJ 


will cause the program to be executed until the next 
program counter altering instruction is reached. The 
registers will then be displayed and the programmer 
prompted for another command. 


The registers will be displayed before each PC altering 
instruction unless the TNJ command is used. 
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TNJ -— TRACE JUMPS WITH NO DISPLAY 


TNI 
TNJ number of instructions 
TNJI {expr} 


The TNJ command is similar to the TJ command except that 
no information is displayed as the trace progresses. 
When the trace terminates, the standard register 
information is displayed. 
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V — VERIFY MEMORY 


Verify that the block of memory between source address 
and source end contain the same value as the block 
beginning at destination address. The addresses and 
contents are displayed for each discrepancy found. The 
following is the format of this command: 


V source-addr source-end destination-addr 
V source-addr S swath-width destination-addr 


The command works by reading bytes from the source and 
destination and comparing them. 


If a discrepancy is found it is displayed in the 
following order: source address, source contents, 
destination contents, destination address. In the 
example that follows, memory locations 0003H and 1003H 
do not compare as the same. The same is true of 
locations 0008H and 1008H. 


-V 0 S30 1000 
0003 32 12 1003 
0008 7A 5A 1008 
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W —- WRITE DISK FILE 


The W command is used to write out parts of memory to a 
disk file. The file name may have previously been 
specified with the F command or may be the file which 
was specified on the Debug command line. There are four 
possible formats: 


W 

W beginning-addr ending-addr 

W beginning-addr S swath-width 
W ,ending-addr 


The first format will write out memory from 100H to the 
last specified by "NEXT =" address (from the last R 
command). If no R command has been executed, one record 
(128 bytes) will be written. 


In the second and third formats the indicated memory 
will be written out. The fourth format specifies memory 
between 100H and ending-addr. 


If the number of bytes is not a multiple of 128 (record 
size), it will be rounded upward. Memory locations less 
than 100H should not be specified because 5CH contains 
the FCB and 80H contains the disk buffer. 
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Z —- ZAP MEMORY 


Z beginning-addr ending-addr string-of-bytes 
Z beginning-addr S swath-width string-of-bytes 


This command is used to initialize a portion of memory. 
The memory from beginning-addr to ending-addr is 
initialized with the string-of-bytes repeated over and 


over. The string-of-bytes is in exactly the same format 
as in the S or SM command. 


-Z 100 S400 0 (zeros everything from 100H to 3FFH) 
-Z 1000 S10 0 1 ‘ABC! 


1000 00 01 41 42 43 00 01 41 42 43 00 01 41 42 43 00 ..ABC..ABC..ABC, 
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A. 


The following 


commands. 


Command 
A 


EJ 


vy O SB FF G&G A 


wm 


S or SM 


Sr 


SUMMARY OF DEBUG COMMANDS 


is 


Appendix A 


an alphabetical list of the 


D ar 
Assemble into memory 

Set and display Break points 
Delete Break points 


Trace Over Calls 


Debug 


Trace Over Calls with No display 


Trace Over Calls with Jumps 


Trace Over Calls with Jumps and No 


Display 


Display Memory 
Display Register 
Examine input port 
EJect disk 


Specify disk File name 


Go 


Hexadecimal arithmetic 

List in assembler mnemonics 
Move memory 

Output to data port 

Program PROMs 

Query memory 

Read disk file 

Substitute Memory 


Substitute 
Summary of Register Names) 
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Trace 

Trace with No display 

Trace Jumps 

Trace Jumps with No Display 


Verify memory 
Write disk file 
Zap memory 
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Appendix B 


SUMMARY OF REGISTER NAMES 


The following register names are displayed by the DM 
command and may be used with the Sr command. 


Regist D tos 
F Flags, the following flags may be changed. 


S - Sign flag 

Z2- Zero flag 

H - Half carry flag 

V- parity/oVerflow flag 
N - subtractioN flag 

Cc 


- Carry flag 
The interrupt enable flag (E) may also be 
changed. 

Fr The F' flags are the same as the F flags. 
(Note that the E flag may not be changed 
here.) 

A accumulator 

A’ . Prime Accumulator 

B B register 

B! B' register 

Cc C register 

Cc! C' register 

D D register 

D! D' register 

E E register 

gE! E' register 

H H register 

H' H' register 

L L register 
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I! L' register 

BC BC register pair 

BC! BC' register pair 

DE DE register pair 

DE' DE' register pair 

HL HL register pair 

HL! HL' register pair 

SP Stack Pointer 

S 

PC Program Counter 

P 

IX IX register 

X 

IY IY register 

Y 

I Interrupt page register 
IP Interrupt page register as top byte 
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Appendix C 


CDOS DISK DIRECTORY 


The CDOS disk file directory is available to the user. 
In response to the CDOS prompt type: 


debug sys.dir 


This will load the disk directory into memory starting 
at location 100H. The programmer may examine it (using 
the DM command), change it (using the SM command), and 
if necessary write it back to the disk (using the W 
command). Users who are not familiar with the structure 
of the disk directory should not attempt to use this 
feature. 
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E (command), 19 

EJ (command), 20 

Eject Disk, 20 

Errors, 6 

Examine Input Port, 19 


F (command), 21 


G (command), 22 
Go, 22 


H (command), 23 
Hexadecimal Arithmetic, 23 


L (command), 24 
List In Assembler Mnemonics, 24 
Loading Debug, 1 


M (command), 25 
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O (command), 26 
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P (command), 27 
Program Proms, 27 


Q (command), 28 
Query Memory, 28 


R (command), 29 
Read Disk File, 29 


S (command), 30 

Set Permanent Break Points, 8 
SM (command), 30 

Specify File Name, 21 

Sr (command), 32 

Substitute Memory, 30 
Substitute Register, 32 
Summary Of Register Names, 43 
Swath Operator, 6 


T (command), 33 

TJ (command), 35 

TN (command), 34 

TNJ (command), 36 

Trace, 33 

Trace Jumps, 35 

Trace Jumps With No Display, 36 
Trace Over Calls, 12 

Trace Over Calls With Jumps, 14 
Trace Over Calls With Jumps And No Display, 15 
Trace Over Calls With No Display, 13 
Trace With No Display, 34 * 


V (command), 37 
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